home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 226-250 / disk_237 / dplot / readme < prev    next >
Text File  |  1992-05-06  |  5KB  |  116 lines
  1.  
  2.     About a year ago I made an attempt to divert Amiga's
  3. graphics-support to a signal-processing environment. My first objective
  4. was a simple display for experimental data satisfying the following:
  5.  
  6.     (i) "Paging" through lots of data
  7.     (ii) Comfortable scaling and presentation.
  8.  
  9. This piece of code was the first (dissatisfying) working example
  10. of what I had in mind (Lattice 3.03, complete with union kludges).
  11. It is considered to be Freeware in the usual sense.
  12.     Since I think the Amiga is well suited for a straightforward
  13. interactive scientific environment, I am rewriting the old
  14. version under Lattice 5.02. The revision will include:
  15.  
  16.     - A better filerequester
  17.     - A rastportdump
  18.     - Vertical "soft" scroll
  19.     - Gadgets in double menu requester
  20.     - "Soft" compress and expand of the data
  21.     - Customisation of the datawindow(s)
  22.  
  23. This version is intended to become the basis for further developments
  24. using the complex plane, FFT, filtering and systemdynamics.
  25.  
  26.   Any suggestions or information about scientific software on the Amiga
  27. is appreciated. I am particularly interested in a comfortable and
  28. interactive display of theoretical concepts and of experimental data.
  29. What can we learn from the "crash-boom-beng" people in order
  30. to visualize or animate our physical data in a time or configurational
  31. domain.
  32.  
  33.   If you find this program useful and are interested in signalprocessing,
  34. graphics (loci of rotating vectors in the complex plane) ,kinematics
  35. (families of curves like epi and hypocycloids), music (analytical
  36. approximations of a soundtrack for instance),chaos or stochastic
  37. processes, send $10 (Europe $8 or so) to:
  38.  
  39.             A.A.Walma
  40.             Ziegelmattenstrasse 5
  41.             7800 FREIBURG
  42.             W-Germany
  43.  
  44. You'll become a registered user and I'll support the use by answering
  45. questions and send you notice of other versions.In Germany you can contact
  46. me under 0761-64832.
  47.  
  48.     --------------------------------------------------------------------
  49.  
  50.                                Dplot 1.0
  51.  
  52.                           (c) 1987 A.A.Walma
  53.  
  54.  
  55.     The program is started either from CLI by invoking "NTSC_dplot <cr>"
  56. for vertically 200 lines and "PAL_dplot <cr>" for vertically 256 lines,
  57. or from the Workbench, where the icons are selfexplanatory.
  58. In both cases the "mathtrans.library" file must be in the "libs" directory
  59. since this program was developed under Lattice 3.03 where the
  60. FFP libraries are opened explicitly.
  61.  
  62.     Dplot works within an integer-range of 0-10000. This
  63. suffices for the usual 8-Bit and 12-Bit AD converters. Only with binary
  64. data (soundfiles for instance) negative values are accepted (-127/128).
  65. ASCII data are considered to be positive only. Two examples of
  66. experimental data are included:
  67.  
  68.     - sound  = A soundtrack from an 8-Bit digitizer as the binary
  69.                    example (100000 data with a sampling rate of ca 28 kHz)
  70.     - eeg    = A sample of a 12-Bit brainwave digitalisation (10500
  71.                    data at a sampling rate of 250 Hz)
  72.  
  73.     The filerequester asks you for the total number of data to be read in.
  74. With "starting index" is meant the first datum in the display (default
  75. is one). If you have lots of data and not so much RAM, you may want to start
  76. at 78000 for instance and put in 90000 for the "total number". RAM is only
  77. needed for 12000 then.
  78.  
  79.     NOK (="Not OK") brings you back to the main menu and with OK the first
  80. 590 datasamples are being displayed. The display is "pixeloriented". In
  81. other words, each horizontal pixel represents a sampled value and each
  82. vertical pixel an amplitude-unit. Reading in "eeg" shows what this
  83. means since this signal varies in real amplitude from ca 2000-7000, whereas
  84. the displayheight amounts to 200. You can measure this by leftklicking
  85. the mouse if the cursor is in the displayfield.
  86.  
  87.     The gadgets to the right are activated in the usual way by a left-
  88. klick on the mousebutton. The first four (in the new version by means
  89. of a dynamic potscroll) gadgets are for vertical "paging". The first two
  90. by means of 200 pixels (=one pageheight), the second two by means of 20
  91. pixels. The next gadget (left) is for reducing the amplitude by a factor
  92. of two each time the gadget is activated. You need to press several times
  93. of course for the "eeg" signal.
  94.  
  95.     The gadget at right changes the window-layout.
  96. Pressing several times shows the idea. By using the blue arrow you can
  97. "page" quickly through the data. This offers the possibility to look
  98. for transients or other interesting parts of the data. Klicking once with
  99. the left-mouse button in the displayfield allows you to locate the part
  100. you are interested in. This is done by pressing the left-mouse button
  101. one more time. Going back to the original display (by means of "OK")
  102. shows the data from where you put the vertical line. You can check this
  103. again by leftklicking in the displayfield.
  104.  
  105.     The gadget below (see "x"),expands the data by a factor of two.
  106. This means by activating once there are 590/2 data on the screen. The blue
  107. arrow is now "paging" with 285 data. In both windows the UNDO gagdet
  108. is restoring the original situation (and not the last modification).
  109.  
  110.     The relative gadget below "scrolls" the data maximally 590 values.
  111. Each klick with the left-mouse button means one datum forward
  112. (or backward).
  113.  
  114.  
  115.     --------------------------------------------------------------------
  116.